home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / hsc / docs-source / project / hscdepp.hsc next >
Encoding:
Text File  |  1997-06-15  |  2.7 KB  |  94 lines
  1. <WEBPAGE chapter="hsc - Project Management - " title="Hscdepp"
  2.     BACK="index.html"
  3.     PREV="makefile.html"
  4.     NEXT="hscpaltrow.html">
  5.  
  6. <*
  7. ** macro to format an explanation
  8. *>
  9. <$MACRO explan TITLE:string/r NAME:string>
  10. <DT>
  11. <$stripws>
  12. <** create named reference **>
  13. <$IF COND=(SET NAME)>
  14.     <A NAME=(Name)>
  15. <$ELSE>
  16.     <A NAME=(Title)>
  17. </$IF>
  18. <$stripws>
  19. <KBD><(Title)></KBD></A>
  20. <DD>
  21. </$MACRO>
  22.  
  23. <STRONG>hsc DEPendency Procreator</STRONG>
  24.  
  25. <P><hscdepp CAP> extracts dependencies from <hsc>'s project-file
  26. and stores them in a <makefile>. But not all parts of the
  27. <makefile> are overwritten: the relevant dependencies for
  28. <hscdepp> are marked with taglines, so the next time only
  29. this part is manipulated and the rest is left untouched.</P>
  30.  
  31. <P><hscdepp CAP> is part of the hsc-distribution and therefor the
  32. same legal issues apply.</P>
  33.  
  34. <hscdepp CAP> is dedicated to Johnny Depp.
  35.  
  36. <H2>Options</H2>
  37.  
  38. <DL>
  39. <EXPLAN TITLE="HELP=-h=?/S">
  40. Display short help message and exit.
  41.  
  42. <EXPLAN TITLE="LICENSE/S">    
  43. Display a short version of <A HREF=":copy.html">Copyright</A>
  44. and exit.
  45.  
  46. <EXPLAN TITLE="FILE" NAME="file">
  47. Specifies makefile to be manipulated. If none given,
  48. <hscdepp> searches for <FILE>GNUmakefile</FILE>, <FILE>makefile</FILE>
  49. or <FILE>Makefile</FILE>. If it doesn't succeed in any of
  50. these, a new one named <FILE>Makefile</FILE> will be
  51. created.
  52.  
  53. <EXPLAN TITLE="PRJFILE/K" NAME="prjfile">
  54. Specifies project-file to be scanned for dependencies. If
  55. none given, <FILE>hsc.project</FILE> is used.
  56.  
  57. <EXPLAN TITLE="NAMEALL/K" NAME="nameall">
  58. All document rules are collected together in a rule by default
  59. called <qq><CODE>all_hsc</CODE></qq>. This is used to update
  60. all documents using a simpe <KBD>make all_hsc</KBD>, or, even
  61. more useful, to be part of your <CODE>all</CODE> rule, which
  62. usually depends on all other things that are maintained by
  63. the <makefile>. This option changes the name of this rule.
  64.  
  65. <EXPLAN TITLE="VERBOSE/S">
  66. Verbose output
  67.  
  68. <EXPLAN TITLE="NOBACKUP/S">
  69. Do not create backup of original <makefile>.
  70.  
  71. <EXPLAN TITLE="NOTAGLINES/S">
  72. Do not write taglines that identify beginning/ending of
  73. dependencies. This should only be used if you keep the
  74. dependencies in a separate file.
  75. </DL>
  76.  
  77. <H2>Examples</H2>
  78.  
  79. <DL>
  80. <DT><KBD>hscdepp HELP</KBD>
  81. <DD>Displays help and exits.
  82. <DT><KBD>hscdepp FILE=hsc_makefile PRJFILE=my_hsc_project VERBOSE</KBD>
  83. <DD>Reads the file <FILE>hsc_makefile</FILE>, reads
  84. project-information from file <FILE>my_hsc_project</FILE>,
  85. creates a backup of the original makefile in
  86. <FILE>hsc_makefile.bak</FILE> and writes the updated
  87. makefile to <FILE>hsc_makefile</FILE>.
  88. <DT><KBD>hscdepp</KBD>
  89. <DD>Does the same as above, but uses <FILE>makefile</FILE> and
  90. <FILE>hsc.project</FILE> as default.
  91. </DL>
  92.  
  93. </WEBPAGE>
  94.